<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html><head><title>QVariant Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
td.postheader { font-family: sans-serif }
tr.address { font-family: sans-serif }
body { background: #ffffff; color: black; }
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">&#160;&#160;</td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a>&#160;&#183; <a href="classes.html"><font color="#004faf">All Classes</font></a>&#160;&#183; <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QVariant Class Reference<br /><sup><sup>[<a href="qtcore.html">QtCore</a> module]</sup></sup></h1><p>The QVariant class acts like a union for the most common Qt data
types. <a href="#details">More...</a></p>

<h3>Types</h3><ul><li><div class="fn" />enum <b><a href="qvariant.html#Type-enum">Type</a></b> { Invalid, Bool, Int, UInt, ..., UserType }</li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qvariant.html#QVariant">__init__</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qvariant.html#QVariant-2">__init__</a></b> (<i>self</i>, Type&#160;<i>type</i>)</li><li><div class="fn" /><b><a href="qvariant.html#QVariant-3">__init__</a></b> (<i>self</i>, int&#160;<i>typeOrUserType</i>, sip.voidptr&#160;<i>copy</i>)</li><li><div class="fn" /><b><a href="qvariant.html#QVariant-4">__init__</a></b> (<i>self</i>, QVariant&#160;<i>other</i>)</li><li><div class="fn" /><b><a href="qvariant.html#QVariant-5">__init__</a></b> (<i>self</i>, object)</li><li><div class="fn" />bool <b><a href="qvariant.html#canConvert">canConvert</a></b> (<i>self</i>, Type&#160;<i>t</i>)</li><li><div class="fn" /><b><a href="qvariant.html#clear">clear</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#convert">convert</a></b> (<i>self</i>, Type&#160;<i>t</i>)</li><li><div class="fn" />sip.voidptr <b><a href="qvariant.html#data">data</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qvariant.html#detach">detach</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#isDetached">isDetached</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#isNull">isNull</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#isValid">isValid</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qvariant.html#load">load</a></b> (<i>self</i>, QDataStream&#160;<i>ds</i>)</li><li><div class="fn" /><b><a href="qvariant.html#save">save</a></b> (<i>self</i>, QDataStream&#160;<i>ds</i>)</li><li><div class="fn" /><b><a href="qvariant.html#swap">swap</a></b> (<i>self</i>, QVariant&#160;<i>other</i>)</li><li><div class="fn" />QBitArray <b><a href="qvariant.html#toBitArray">toBitArray</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#toBool">toBool</a></b> (<i>self</i>)</li><li><div class="fn" />QByteArray <b><a href="qvariant.html#toByteArray">toByteArray</a></b> (<i>self</i>)</li><li><div class="fn" />QChar <b><a href="qvariant.html#toChar">toChar</a></b> (<i>self</i>)</li><li><div class="fn" />QDate <b><a href="qvariant.html#toDate">toDate</a></b> (<i>self</i>)</li><li><div class="fn" />QDateTime <b><a href="qvariant.html#toDateTime">toDateTime</a></b> (<i>self</i>)</li><li><div class="fn" />(float, bool&#160;<i>ok</i>) <b><a href="qvariant.html#toDouble">toDouble</a></b> (<i>self</i>)</li><li><div class="fn" />QEasingCurve <b><a href="qvariant.html#toEasingCurve">toEasingCurve</a></b> (<i>self</i>)</li><li><div class="fn" />(float, bool&#160;<i>ok</i>) <b><a href="qvariant.html#toFloat">toFloat</a></b> (<i>self</i>)</li><li><div class="fn" />dict-of-QString-QVariant <b><a href="qvariant.html#toHash">toHash</a></b> (<i>self</i>)</li><li><div class="fn" />(int, bool&#160;<i>ok</i>) <b><a href="qvariant.html#toInt">toInt</a></b> (<i>self</i>)</li><li><div class="fn" />QLine <b><a href="qvariant.html#toLine">toLine</a></b> (<i>self</i>)</li><li><div class="fn" />QLineF <b><a href="qvariant.html#toLineF">toLineF</a></b> (<i>self</i>)</li><li><div class="fn" />list-of-QVariant <b><a href="qvariant.html#toList">toList</a></b> (<i>self</i>)</li><li><div class="fn" />QLocale <b><a href="qvariant.html#toLocale">toLocale</a></b> (<i>self</i>)</li><li><div class="fn" />(int, bool&#160;<i>ok</i>) <b><a href="qvariant.html#toLongLong">toLongLong</a></b> (<i>self</i>)</li><li><div class="fn" />dict-of-QString-QVariant <b><a href="qvariant.html#toMap">toMap</a></b> (<i>self</i>)</li><li><div class="fn" />QPoint <b><a href="qvariant.html#toPoint">toPoint</a></b> (<i>self</i>)</li><li><div class="fn" />QPointF <b><a href="qvariant.html#toPointF">toPointF</a></b> (<i>self</i>)</li><li><div class="fn" />object <b><a href="qvariant.html#toPyObject">toPyObject</a></b> (<i>self</i>)</li><li><div class="fn" />(float, bool&#160;<i>ok</i>) <b><a href="qvariant.html#toReal">toReal</a></b> (<i>self</i>)</li><li><div class="fn" />QRect <b><a href="qvariant.html#toRect">toRect</a></b> (<i>self</i>)</li><li><div class="fn" />QRectF <b><a href="qvariant.html#toRectF">toRectF</a></b> (<i>self</i>)</li><li><div class="fn" />QRegExp <b><a href="qvariant.html#toRegExp">toRegExp</a></b> (<i>self</i>)</li><li><div class="fn" />QSize <b><a href="qvariant.html#toSize">toSize</a></b> (<i>self</i>)</li><li><div class="fn" />QSizeF <b><a href="qvariant.html#toSizeF">toSizeF</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qvariant.html#toString">toString</a></b> (<i>self</i>)</li><li><div class="fn" />QStringList <b><a href="qvariant.html#toStringList">toStringList</a></b> (<i>self</i>)</li><li><div class="fn" />QTime <b><a href="qvariant.html#toTime">toTime</a></b> (<i>self</i>)</li><li><div class="fn" />(int, bool&#160;<i>ok</i>) <b><a href="qvariant.html#toUInt">toUInt</a></b> (<i>self</i>)</li><li><div class="fn" />(int, bool&#160;<i>ok</i>) <b><a href="qvariant.html#toULongLong">toULongLong</a></b> (<i>self</i>)</li><li><div class="fn" />QUrl <b><a href="qvariant.html#toUrl">toUrl</a></b> (<i>self</i>)</li><li><div class="fn" />Type <b><a href="qvariant.html#type">type</a></b> (<i>self</i>)</li><li><div class="fn" />str <b><a href="qvariant.html#typeName">typeName</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qvariant.html#userType">userType</a></b> (<i>self</i>)</li></ul><h3>Static Methods</h3><ul><li><div class="fn" />QVariant <b><a href="qvariant.html#fromList">fromList</a></b> (list-of-QVariant&#160;<i>list</i>)</li><li><div class="fn" />QVariant <b><a href="qvariant.html#fromMap">fromMap</a></b> (dict-of-QString-QVariant&#160;<i>map</i>)</li><li><div class="fn" />Type <b><a href="qvariant.html#nameToType">nameToType</a></b> (str&#160;<i>name</i>)</li><li><div class="fn" />str <b><a href="qvariant.html#typeToName">typeToName</a></b> (Type&#160;<i>type</i>)</li></ul><h3>Special Methods</h3><ul><li><div class="fn" />bool <b><a href="qvariant.html#__eq__">__eq__</a></b> (<i>self</i>, QVariant&#160;<i>v</i>)</li><li><div class="fn" />bool <b><a href="qvariant.html#__ne__">__ne__</a></b> (<i>self</i>, QVariant&#160;<i>v</i>)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>Any Python object may be used whenever a
    <a href="qvariant.html">QVariant</a> is expected. None will be
    interpreted as an invalid QVariant.</p>
  <p>The QVariant class acts like a union for the most common Qt data
types.</p>
<p>Because C++ forbids unions from including types that have
non-default constructors or destructors, most interesting Qt
classes cannot be used in unions. Without QVariant, this would be a
problem for <a href="qobject.html#property">QObject.property</a>()
and for database work, etc.</p>
<p>A QVariant object holds a single value of a single <a href="qvariant.html#type">type</a>() at a time. (Some <a href="qvariant.html#type">type</a>()s are multi-valued, for example a
string list.) You can find out what type, T, the variant holds,
convert it to a different type using <a href="qvariant.html#convert">convert</a>(), get its value using one of
the toT() functions (e.g., <a href="qvariant.html#toSize">toSize</a>()) and check whether the type can
be converted to a particular type using <a href="qvariant.html#canConvert">canConvert</a>().</p>
<p>The methods named toT() (e.g., <a href="qvariant.html#toInt">toInt</a>(), <a href="qvariant.html#toString">toString</a>()) are const. If you ask for
the stored type, they return a copy of the stored object. If you
ask for a type that can be generated from the stored type, toT()
copies and converts and leaves the object itself unchanged. If you
ask for a type that cannot be generated from the stored type, the
result depends on the type; see the function documentation for
details.</p>
<p>Here is some example code to demonstrate the use of
QVariant:</p>
<pre class="cpp">
 <span class="type"><a href="qdatastream.html">QDataStream</a></span> out(<span class="operator">.</span><span class="operator">.</span><span class="operator">.</span>);
 <span class="type">QVariant</span> v(<span class="number">123</span>);                <span class="comment">// The variant now contains an int</span>
 <span class="type">int</span> x <span class="operator">=</span> v<span class="operator">.</span><a href="qvariant.html#toInt">toInt</a>();              <span class="comment">// x = 123</span>
 out <span class="operator">&lt;</span><span class="operator">&lt;</span> v;                       <span class="comment">// Writes a type tag and an int to out</span>
 v <span class="operator">=</span> <span class="type">QVariant</span>(<span class="string">"hello"</span>);          <span class="comment">// The variant now contains a QByteArray</span>
 v <span class="operator">=</span> <span class="type">QVariant</span>(tr(<span class="string">"hello"</span>));      <span class="comment">// The variant now contains a QString</span>
 <span class="type">int</span> y <span class="operator">=</span> v<span class="operator">.</span><a href="qvariant.html#toInt">toInt</a>();              <span class="comment">// y = 0 since v cannot be converted to an int</span>
 <span class="type"><a href="qstring.html">QString</a></span> s <span class="operator">=</span> v<span class="operator">.</span><a href="qvariant.html#toString">toString</a>();       <span class="comment">// s = tr("hello")  (see QObject.tr())</span>
 out <span class="operator">&lt;</span><span class="operator">&lt;</span> v;                       <span class="comment">// Writes a type tag and a QString to out</span>
 <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span>
 <span class="type"><a href="qdatastream.html">QDataStream</a></span> in(<span class="operator">.</span><span class="operator">.</span><span class="operator">.</span>);            <span class="comment">// (opening the previously written stream)</span>
 in <span class="operator">&gt;</span><span class="operator">&gt;</span> v;                        <span class="comment">// Reads an Int variant</span>
 <span class="type">int</span> z <span class="operator">=</span> v<span class="operator">.</span><a href="qvariant.html#toInt">toInt</a>();              <span class="comment">// z = 123</span>
 <a href="qtcore.html#qDebug">qDebug</a>(<span class="string">"Type is %s"</span><span class="operator">,</span>            <span class="comment">// prints "Type is int"</span>
         v<span class="operator">.</span>typeName());
 v <span class="operator">=</span> v<span class="operator">.</span><a href="qvariant.html#toInt">toInt</a>() <span class="operator">+</span> <span class="number">100</span>;            <span class="comment">// The variant now hold the value 223</span>
 v <span class="operator">=</span> <span class="type">QVariant</span>(<span class="type"><a href="qstringlist.html">QStringList</a></span>());
</pre>
<p>You can even store <a href="qlist.html">QList</a>&lt;QVariant&gt; and <a href="qmap.html">QMap</a>&lt;<a href="qstring.html">QString</a>,
QVariant&gt; values in a variant, so you can easily construct
arbitrarily complex data structures of arbitrary types. This is
very powerful and versatile, but may prove less memory and speed
efficient than storing specific types in standard data
structures.</p>
<p>QVariant also supports the notion of null values, where you can
have a defined type with no value set. However, note that QVariant
types can only be cast when they have had a value set.</p>
<pre class="cpp">
 <span class="type">QVariant</span> x<span class="operator">,</span> y(<span class="type"><a href="qstring.html">QString</a></span>())<span class="operator">,</span> z(<span class="type"><a href="qstring.html">QString</a></span>(<span class="string">""</span>));
 x<span class="operator">.</span><a href="qvariant.html#convert">convert</a>(<span class="type">QVariant</span><span class="operator">.</span>Int);
 <span class="comment">// x.isNull() == true</span>
 <span class="comment">// y.isNull() == true, z.isNull() == false</span>
</pre>
<p>QVariant can be extended to support other types than those
mentioned in the <a href="qvariant.html#Type-enum">Type</a> enum.
See the <a href="qmetatype.html">QMetaType</a> documentation for
details.</p>
<a id="a-note-on-gui-types" name="a-note-on-gui-types" />
<h3>A Note on GUI Types</h3>
<p>Because QVariant is part of the <a href="qtcore.html">QtCore</a>
library, it cannot provide conversion functions to data types
defined in <a href="qtgui.html">QtGui</a>, such as <a href="qcolor.html">QColor</a>, <a href="qimage.html">QImage</a>, and
<a href="qpixmap.html">QPixmap</a>. In other words, there is no
<tt>toColor()</tt> function. Instead, you can use the <a href="qvariant.html#value">QVariant.value</a>() or the <a href="qvariant.html#qvariant_cast">qvariant_cast</a>() template
function. For example:</p>
<pre class="cpp">
 <span class="type">QVariant</span> variant;
 <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span>
 <span class="type"><a href="qcolor.html">QColor</a></span> color <span class="operator">=</span> variant<span class="operator">.</span>value<span class="operator">&lt;</span><span class="type"><a href="qcolor.html">QColor</a></span><span class="operator">&gt;</span>();
</pre>
<p>The inverse conversion (e.g., from <a href="qcolor.html">QColor</a> to QVariant) is automatic for all data
types supported by QVariant, including GUI-related types:</p>
<pre class="cpp">
 <span class="type"><a href="qcolor.html">QColor</a></span> color <span class="operator">=</span> palette()<span class="operator">.</span>background()<span class="operator">.</span>color();
 <span class="type">QVariant</span> variant <span class="operator">=</span> color;
</pre>
<a id="using-canconvert-and-convert-consecutively" name="using-canconvert-and-convert-consecutively" />
<h3>Using canConvert() and convert() Consecutively</h3>
<p>When using <a href="qvariant.html#canConvert">canConvert</a>()
and <a href="qvariant.html#convert">convert</a>() consecutively, it
is possible for <a href="qvariant.html#canConvert">canConvert</a>()
to return true, but <a href="qvariant.html#convert">convert</a>()
to return false. This is typically because <a href="qvariant.html#canConvert">canConvert</a>() only reports the
general ability of QVariant to convert between types given suitable
data; it is still possible to supply data which cannot actually be
converted.</p>
<p>For example, <a href="qvariant.html#canConvert">canConvert</a>()
would return true when called on a variant containing a string
because, in principle, QVariant is able to convert strings of
numbers to integers. However, if the string contains non-numeric
characters, it cannot be converted to an integer, and any attempt
to convert it will fail. Hence, it is important to have both
functions return true for a successful conversion.</p>
<hr /><h2>Type Documentation</h2><h3 class="fn"><a name="Type-enum" />QVariant.Type</h3><p>This enum type defines the types of variable that a <a href="qvariant.html">QVariant</a> can contain.</p>
<table class="valuelist">
<tr class="odd" valign="top">
<th class="tblConst">Constant</th>
<th class="tblval">Value</th>
<th class="tbldscr">Description</th>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Invalid</tt></td>
<td class="topAlign"><tt>0</tt></td>
<td class="topAlign">no type</td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.BitArray</tt></td>
<td class="topAlign"><tt>13</tt></td>
<td class="topAlign">a <a href="qbitarray.html">QBitArray</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Bitmap</tt></td>
<td class="topAlign"><tt>73</tt></td>
<td class="topAlign">a <a href="qbitmap.html">QBitmap</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Bool</tt></td>
<td class="topAlign"><tt>1</tt></td>
<td class="topAlign">a bool</td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Brush</tt></td>
<td class="topAlign"><tt>66</tt></td>
<td class="topAlign">a <a href="qbrush.html">QBrush</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.ByteArray</tt></td>
<td class="topAlign"><tt>12</tt></td>
<td class="topAlign">a <a href="qbytearray.html">QByteArray</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Char</tt></td>
<td class="topAlign"><tt>7</tt></td>
<td class="topAlign">a <a href="qchar.html">QChar</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Color</tt></td>
<td class="topAlign"><tt>67</tt></td>
<td class="topAlign">a <a href="qcolor.html">QColor</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Cursor</tt></td>
<td class="topAlign"><tt>74</tt></td>
<td class="topAlign">a <a href="qcursor.html">QCursor</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Date</tt></td>
<td class="topAlign"><tt>14</tt></td>
<td class="topAlign">a <a href="qdate.html">QDate</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.DateTime</tt></td>
<td class="topAlign"><tt>16</tt></td>
<td class="topAlign">a <a href="qdatetime.html">QDateTime</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Double</tt></td>
<td class="topAlign"><tt>6</tt></td>
<td class="topAlign">a double</td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.EasingCurve</tt></td>
<td class="topAlign"><tt>29</tt></td>
<td class="topAlign">a <a href="qeasingcurve.html">QEasingCurve</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Font</tt></td>
<td class="topAlign"><tt>64</tt></td>
<td class="topAlign">a <a href="qfont.html">QFont</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Hash</tt></td>
<td class="topAlign"><tt>28</tt></td>
<td class="topAlign">a <a href="qvariant.html#QVariantHash-typedef">QVariantHash</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Icon</tt></td>
<td class="topAlign"><tt>69</tt></td>
<td class="topAlign">a <a href="qicon.html">QIcon</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Image</tt></td>
<td class="topAlign"><tt>70</tt></td>
<td class="topAlign">a <a href="qimage.html">QImage</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Int</tt></td>
<td class="topAlign"><tt>2</tt></td>
<td class="topAlign">an int</td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.KeySequence</tt></td>
<td class="topAlign"><tt>76</tt></td>
<td class="topAlign">a <a href="qkeysequence.html">QKeySequence</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Line</tt></td>
<td class="topAlign"><tt>23</tt></td>
<td class="topAlign">a <a href="qline.html">QLine</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.LineF</tt></td>
<td class="topAlign"><tt>24</tt></td>
<td class="topAlign">a <a href="qlinef.html">QLineF</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.List</tt></td>
<td class="topAlign"><tt>9</tt></td>
<td class="topAlign">a <a href="qvariant.html#QVariantList-typedef">QVariantList</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Locale</tt></td>
<td class="topAlign"><tt>18</tt></td>
<td class="topAlign">a <a href="qlocale.html">QLocale</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.LongLong</tt></td>
<td class="topAlign"><tt>4</tt></td>
<td class="topAlign">a <a href="qtcore.html#qlonglong-typedef">qlonglong</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Map</tt></td>
<td class="topAlign"><tt>8</tt></td>
<td class="topAlign">a <a href="qvariant.html#QVariantMap-typedef">QVariantMap</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Matrix</tt></td>
<td class="topAlign"><tt>80</tt></td>
<td class="topAlign">a <a class="obsolete" href="qmatrix.html">QMatrix<sup>(obsolete)</sup></a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Transform</tt></td>
<td class="topAlign"><tt>81</tt></td>
<td class="topAlign">a <a href="qtransform.html">QTransform</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Matrix4x4</tt></td>
<td class="topAlign"><tt>82</tt></td>
<td class="topAlign">a <a href="qmatrix4x4.html">QMatrix4x4</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Palette</tt></td>
<td class="topAlign"><tt>68</tt></td>
<td class="topAlign">a <a href="qpalette.html">QPalette</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Pen</tt></td>
<td class="topAlign"><tt>77</tt></td>
<td class="topAlign">a <a href="qpen.html">QPen</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Pixmap</tt></td>
<td class="topAlign"><tt>65</tt></td>
<td class="topAlign">a <a href="qpixmap.html">QPixmap</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Point</tt></td>
<td class="topAlign"><tt>25</tt></td>
<td class="topAlign">a <a href="qpoint.html">QPoint</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.PointArray</tt></td>
<td class="topAlign"><tt>Polygon</tt></td>
<td class="topAlign">a <a href="porting4.html#qpointarray">QPointArray</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.PointF</tt></td>
<td class="topAlign"><tt>26</tt></td>
<td class="topAlign">a <a href="qpointf.html">QPointF</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Polygon</tt></td>
<td class="topAlign"><tt>71</tt></td>
<td class="topAlign">a <a href="qpolygon.html">QPolygon</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Quaternion</tt></td>
<td class="topAlign"><tt>86</tt></td>
<td class="topAlign">a <a href="qquaternion.html">QQuaternion</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Rect</tt></td>
<td class="topAlign"><tt>19</tt></td>
<td class="topAlign">a <a href="qrect.html">QRect</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.RectF</tt></td>
<td class="topAlign"><tt>20</tt></td>
<td class="topAlign">a <a href="qrectf.html">QRectF</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.RegExp</tt></td>
<td class="topAlign"><tt>27</tt></td>
<td class="topAlign">a <a href="qregexp.html">QRegExp</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Region</tt></td>
<td class="topAlign"><tt>72</tt></td>
<td class="topAlign">a <a href="qregion.html">QRegion</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Size</tt></td>
<td class="topAlign"><tt>21</tt></td>
<td class="topAlign">a <a href="qsize.html">QSize</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.SizeF</tt></td>
<td class="topAlign"><tt>22</tt></td>
<td class="topAlign">a <a href="qsizef.html">QSizeF</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.SizePolicy</tt></td>
<td class="topAlign"><tt>75</tt></td>
<td class="topAlign">a <a href="qsizepolicy.html">QSizePolicy</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.String</tt></td>
<td class="topAlign"><tt>10</tt></td>
<td class="topAlign">a <a href="qstring.html">QString</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.StringList</tt></td>
<td class="topAlign"><tt>11</tt></td>
<td class="topAlign">a <a href="qstringlist.html">QStringList</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.TextFormat</tt></td>
<td class="topAlign"><tt>79</tt></td>
<td class="topAlign">a <a href="qtextformat.html">QTextFormat</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.TextLength</tt></td>
<td class="topAlign"><tt>78</tt></td>
<td class="topAlign">a <a href="qtextlength.html">QTextLength</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Time</tt></td>
<td class="topAlign"><tt>15</tt></td>
<td class="topAlign">a <a href="qtime.html">QTime</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.UInt</tt></td>
<td class="topAlign"><tt>3</tt></td>
<td class="topAlign">a <a href="qtcore.html#uint-typedef">uint</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.ULongLong</tt></td>
<td class="topAlign"><tt>5</tt></td>
<td class="topAlign">a <a href="qtcore.html#qulonglong-typedef">qulonglong</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Url</tt></td>
<td class="topAlign"><tt>17</tt></td>
<td class="topAlign">a <a href="qurl.html">QUrl</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Vector2D</tt></td>
<td class="topAlign"><tt>83</tt></td>
<td class="topAlign">a <a href="qvector2d.html">QVector2D</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Vector3D</tt></td>
<td class="topAlign"><tt>84</tt></td>
<td class="topAlign">a <a href="qvector3d.html">QVector3D</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.Vector4D</tt></td>
<td class="topAlign"><tt>85</tt></td>
<td class="topAlign">a <a href="qvector4d.html">QVector4D</a></td>
</tr>
<tr>
<td class="topAlign"><tt>QVariant.UserType</tt></td>
<td class="topAlign"><tt>127</tt></td>
<td class="topAlign">Base value for user-defined types.</td>
</tr>
</table>
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QVariant" />QVariant.__init__ (<i>self</i>)</h3><p>Constructs an invalid variant.</p>


<h3 class="fn"><a name="QVariant-2" />QVariant.__init__ (<i>self</i>, <a href="qtcore.html#Type-enum">Type</a>&#160;<i>type</i>)</h3><p>Constructs a null variant of type <i>type</i>.</p>


<h3 class="fn"><a name="QVariant-3" />QVariant.__init__ (<i>self</i>, int&#160;<i>typeOrUserType</i>, sip.voidptr&#160;<i>copy</i>)</h3><p>Constructs variant of type <i>typeOrUserType</i>, and
initializes with <i>copy</i> if <i>copy</i> is not 0.</p>
<p>Note that you have to pass the address of the variable you want
stored.</p>
<p>Usually, you never have to use this constructor, use <a href="qvariant.html#fromValue">QVariant.fromValue</a>() instead to
construct variants from the pointer types represented by
<tt>QMetaType.VoidStar</tt>, <tt>QMetaType.QObjectStar</tt> and
<tt>QMetaType.QWidgetStar</tt>.</p>
<p><b>See also</b> <a href="qvariant.html#fromValue">QVariant.fromValue</a>() and <a href="qvariant.html#Type-enum">Type</a>.</p>


<h3 class="fn"><a name="QVariant-4" />QVariant.__init__ (<i>self</i>, QVariant&#160;<i>other</i>)</h3><h3 class="fn"><a name="QVariant-5" />QVariant.__init__ (<i>self</i>, object)</h3><p>Constructs a copy of the variant, <i>p</i>, passed as the
argument to this constructor.</p>


<h3 class="fn"><a name="canConvert" />bool QVariant.canConvert (<i>self</i>, <a href="qtcore.html#Type-enum">Type</a>&#160;<i>t</i>)</h3><p>Returns true if the variant's type can be cast to the requested
type, <i>t</i>. Such casting is done automatically when calling the
<a href="qvariant.html#toInt">toInt</a>(), <a href="qvariant.html#toBool">toBool</a>(), ... methods.</p>
<p>The following casts are done automatically:</p>
<table class="generic">
<thead>
<tr class="qt-style">
<th>Type</th>
<th>Automatically Cast To</th>
</tr>
</thead>
<tr class="odd" valign="top">
<td><a href="qvariant.html#Type-enum">Bool</a></td>
<td><a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td>
</tr>
<tr class="even" valign="top">
<td><a href="qvariant.html#Type-enum">ByteArray</a></td>
<td><a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td>
</tr>
<tr class="odd" valign="top">
<td><a href="qvariant.html#Type-enum">Char</a></td>
<td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td>
</tr>
<tr class="even" valign="top">
<td><a href="qvariant.html#Type-enum">Color</a></td>
<td><a href="qvariant.html#Type-enum">String</a></td>
</tr>
<tr class="odd" valign="top">
<td><a href="qvariant.html#Type-enum">Date</a></td>
<td><a href="qvariant.html#Type-enum">DateTime</a>, <a href="qvariant.html#Type-enum">String</a></td>
</tr>
<tr class="even" valign="top">
<td><a href="qvariant.html#Type-enum">DateTime</a></td>
<td><a href="qvariant.html#Type-enum">Date</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">Time</a></td>
</tr>
<tr class="odd" valign="top">
<td><a href="qvariant.html#Type-enum">Double</a></td>
<td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td>
</tr>
<tr class="even" valign="top">
<td><a href="qvariant.html#Type-enum">Font</a></td>
<td><a href="qvariant.html#Type-enum">String</a></td>
</tr>
<tr class="odd" valign="top">
<td><a href="qvariant.html#Type-enum">Int</a></td>
<td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td>
</tr>
<tr class="even" valign="top">
<td><a href="qvariant.html#Type-enum">KeySequence</a></td>
<td><a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">String</a></td>
</tr>
<tr class="odd" valign="top">
<td><a href="qvariant.html#Type-enum">List</a></td>
<td><a href="qvariant.html#Type-enum">StringList</a> (if the list's
items can be converted to strings)</td>
</tr>
<tr class="even" valign="top">
<td><a href="qvariant.html#Type-enum">LongLong</a></td>
<td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td>
</tr>
<tr class="odd" valign="top">
<td><a href="qvariant.html#Type-enum">Point</a></td>
<td><a href="qvariant.html#Type-enum">PointF</a></td>
</tr>
<tr class="even" valign="top">
<td><a href="qvariant.html#Type-enum">Rect</a></td>
<td><a href="qvariant.html#Type-enum">RectF</a></td>
</tr>
<tr class="odd" valign="top">
<td><a href="qvariant.html#Type-enum">String</a></td>
<td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Color</a>, <a href="qvariant.html#Type-enum">Date</a>, <a href="qvariant.html#Type-enum">DateTime</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Font</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">KeySequence</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">StringList</a>, <a href="qvariant.html#Type-enum">Time</a>, <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td>
</tr>
<tr class="even" valign="top">
<td><a href="qvariant.html#Type-enum">StringList</a></td>
<td><a href="qvariant.html#Type-enum">List</a>, <a href="qvariant.html#Type-enum">String</a> (if the list contains exactly
one item)</td>
</tr>
<tr class="odd" valign="top">
<td><a href="qvariant.html#Type-enum">Time</a></td>
<td><a href="qvariant.html#Type-enum">String</a></td>
</tr>
<tr class="even" valign="top">
<td><a href="qvariant.html#Type-enum">UInt</a></td>
<td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">ULongLong</a></td>
</tr>
<tr class="odd" valign="top">
<td><a href="qvariant.html#Type-enum">ULongLong</a></td>
<td><a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a></td>
</tr>
</table>
<p><b>See also</b> <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="clear" />QVariant.clear (<i>self</i>)</h3><p>Convert this variant to type Invalid and free up any resources
used.</p>


<h3 class="fn"><a name="convert" />bool QVariant.convert (<i>self</i>, <a href="qtcore.html#Type-enum">Type</a>&#160;<i>t</i>)</h3><p>Casts the variant to the requested type, <i>t</i>. If the cast
cannot be done, the variant is cleared. Returns true if the current
type of the variant was successfully cast; otherwise returns
false.</p>
<p><b>Warning:</b> For historical reasons, converting a null
<a href="qvariant.html">QVariant</a> results in a null value of the
desired type (e.g., an empty string for <a href="qstring.html">QString</a>) and a result of false.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#clear">clear</a>().</p>


<h3 class="fn"><a name="data" />sip.voidptr QVariant.data (<i>self</i>)</h3><h3 class="fn"><a name="detach" />QVariant.detach (<i>self</i>)</h3><h3 class="fn"><a name="fromList" />QVariant QVariant.fromList (list-of-QVariant&#160;<i>list</i>)</h3><h3 class="fn"><a name="fromMap" />QVariant QVariant.fromMap (dict-of-QString-QVariant&#160;<i>map</i>)</h3><h3 class="fn"><a name="isDetached" />bool QVariant.isDetached (<i>self</i>)</h3><h3 class="fn"><a name="isNull" />bool QVariant.isNull (<i>self</i>)</h3><p>Returns true if this is a NULL variant, false otherwise.</p>


<h3 class="fn"><a name="isValid" />bool QVariant.isValid (<i>self</i>)</h3><p>Returns true if the storage type of this variant is not <a href="qvariant.html#Type-enum">QVariant.Invalid</a>; otherwise returns
false.</p>


<h3 class="fn"><a name="load" />QVariant.load (<i>self</i>, <a href="qdatastream.html">QDataStream</a>&#160;<i>ds</i>)</h3><h3 class="fn"><a name="nameToType" /><a href="qtcore.html#Type-enum">Type</a> QVariant.nameToType (str&#160;<i>name</i>)</h3><p>Converts the string representation of the storage type given in
<i>name</i>, to its enum representation.</p>
<p>If the string representation cannot be converted to any enum
representation, the variant is set to <tt>Invalid</tt>.</p>


<h3 class="fn"><a name="save" />QVariant.save (<i>self</i>, <a href="qdatastream.html">QDataStream</a>&#160;<i>ds</i>)</h3><h3 class="fn"><a name="swap" />QVariant.swap (<i>self</i>, QVariant&#160;<i>other</i>)</h3><p>Swaps variant <i>other</i> with this variant. This operation is
very fast and never fails.</p>
<p>This function was introduced in Qt 4.8.</p>


<h3 class="fn"><a name="toBitArray" /><a href="qbitarray.html">QBitArray</a> QVariant.toBitArray (<i>self</i>)</h3><p>Returns the variant as a <a href="qbitarray.html">QBitArray</a>
if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">BitArray</a>; otherwise returns an empty
bit array.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toBool" />bool QVariant.toBool (<i>self</i>)</h3><p>Returns the variant as a bool if the variant has <a href="qvariant.html#type">type</a>() Bool.</p>
<p>Returns true if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a> and the value is non-zero,
or if the variant has type <a href="qvariant.html#Type-enum">String</a> or <a href="qvariant.html#Type-enum">ByteArray</a> and its lower-case content
is not empty, "0" or "false"; otherwise returns false.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toByteArray" /><a href="qbytearray.html">QByteArray</a> QVariant.toByteArray (<i>self</i>)</h3><p>Returns the variant as a <a href="qbytearray.html">QByteArray</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">ByteArray</a> or <a href="qvariant.html#Type-enum">String</a> (converted using <a href="qstring.html#fromAscii">QString.fromAscii</a>()); otherwise
returns an empty byte array.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toChar" />QChar QVariant.toChar (<i>self</i>)</h3><p>Returns the variant as a <a href="qchar.html">QChar</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Int</a>, or <a href="qvariant.html#Type-enum">UInt</a>; otherwise returns an invalid
<a href="qchar.html">QChar</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toDate" /><a href="qdate.html">QDate</a> QVariant.toDate (<i>self</i>)</h3><p>Returns the variant as a <a href="qdate.html">QDate</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Date</a>, <a href="qvariant.html#Type-enum">DateTime</a>, or <a href="qvariant.html#Type-enum">String</a>; otherwise returns an invalid
date.</p>
<p>If the <a href="qvariant.html#type">type</a>() is <a href="qvariant.html#Type-enum">String</a>, an invalid date will be
returned if the string cannot be parsed as a <a href="qt.html#DateFormat-enum">Qt.ISODate</a> format date.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toDateTime" /><a href="qdatetime.html">QDateTime</a> QVariant.toDateTime (<i>self</i>)</h3><p>Returns the variant as a <a href="qdatetime.html">QDateTime</a>
if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">DateTime</a>, <a href="qvariant.html#Type-enum">Date</a>, or <a href="qvariant.html#Type-enum">String</a>; otherwise returns an invalid
date/time.</p>
<p>If the <a href="qvariant.html#type">type</a>() is <a href="qvariant.html#Type-enum">String</a>, an invalid date/time will be
returned if the string cannot be parsed as a <a href="qt.html#DateFormat-enum">Qt.ISODate</a> format date/time.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toDouble" />(float, bool&#160;<i>ok</i>) QVariant.toDouble (<i>self</i>)</h3><p>Returns the variant as a double if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Double</a>, <a href="qmetatype.html#Type-enum">QMetaType.Float</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.0.</p>
<p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if
the value could be converted to a double; otherwise
<tt>*</tt><i>ok</i> is set to false.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toEasingCurve" /><a href="qeasingcurve.html">QEasingCurve</a> QVariant.toEasingCurve (<i>self</i>)</h3><p>Returns the variant as a <a href="qeasingcurve.html">QEasingCurve</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">EasingCurve</a>; otherwise returns a
default easing curve.</p>
<p>This function was introduced in Qt 4.7.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toFloat" />(float, bool&#160;<i>ok</i>) QVariant.toFloat (<i>self</i>)</h3><p>Returns the variant as a float if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Double</a>, <a href="qmetatype.html#Type-enum">QMetaType.Float</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.0.</p>
<p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if
the value could be converted to a double; otherwise
<tt>*</tt><i>ok</i> is set to false.</p>
<p>This function was introduced in Qt 4.6.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toHash" />dict-of-QString-QVariant QVariant.toHash (<i>self</i>)</h3><p>Returns the variant as a <a href="qhash.html">QHash</a>&lt;<a href="qstring.html">QString</a>,
<a href="qvariant.html">QVariant</a>&gt; if the variant has
<a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Hash</a>; otherwise returns an empty
map.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toInt" />(int, bool&#160;<i>ok</i>) QVariant.toInt (<i>self</i>)</h3><p>Returns the variant as an int if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.</p>
<p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if
the value could be converted to an int; otherwise
<tt>*</tt><i>ok</i> is set to false.</p>
<p><b>Warning:</b> If the value is convertible to a <a href="qvariant.html#Type-enum">LongLong</a> but is too large to be
represented in an int, the resulting arithmetic overflow will not
be reflected in <i>ok</i>. A simple workaround is to use <a href="qstring.html#toInt">QString.toInt</a>(). Fixing this bug has been
postponed to Qt 5 in order to avoid breaking existing code.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toLine" /><a href="qline.html">QLine</a> QVariant.toLine (<i>self</i>)</h3><p>Returns the variant as a <a href="qline.html">QLine</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Line</a>; otherwise returns an invalid
<a href="qline.html">QLine</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toLineF" /><a href="qlinef.html">QLineF</a> QVariant.toLineF (<i>self</i>)</h3><p>Returns the variant as a <a href="qlinef.html">QLineF</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">LineF</a>; otherwise returns an invalid
<a href="qlinef.html">QLineF</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toList" />list-of-QVariant QVariant.toList (<i>self</i>)</h3><p>Returns the variant as a <a href="qvariant.html#QVariantList-typedef">QVariantList</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">List</a> or <a href="qvariant.html#Type-enum">StringList</a>; otherwise returns an
empty list.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toLocale" /><a href="qlocale.html">QLocale</a> QVariant.toLocale (<i>self</i>)</h3><p>Returns the variant as a <a href="qlocale.html">QLocale</a> if
the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Locale</a>; otherwise returns an invalid
<a href="qlocale.html">QLocale</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toLongLong" />(int, bool&#160;<i>ok</i>) QVariant.toLongLong (<i>self</i>)</h3><p>Returns the variant as a long long int if the variant has
<a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.</p>
<p>If <i>ok</i> is non-null: <tt>*</tt><tt>ok</tt> is set to true
if the value could be converted to an int; otherwise
<tt>*</tt><tt>ok</tt> is set to false.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toMap" />dict-of-QString-QVariant QVariant.toMap (<i>self</i>)</h3><p>Returns the variant as a <a href="qmap.html">QMap</a>&lt;<a href="qstring.html">QString</a>,
<a href="qvariant.html">QVariant</a>&gt; if the variant has
<a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Map</a>; otherwise returns an empty
map.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toPoint" /><a href="qpoint.html">QPoint</a> QVariant.toPoint (<i>self</i>)</h3><p>Returns the variant as a <a href="qpoint.html">QPoint</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Point</a> or <a href="qvariant.html#Type-enum">PointF</a>; otherwise returns a null
<a href="qpoint.html">QPoint</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toPointF" /><a href="qpointf.html">QPointF</a> QVariant.toPointF (<i>self</i>)</h3><p>Returns the variant as a <a href="qpointf.html">QPointF</a> if
the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Point</a> or <a href="qvariant.html#Type-enum">PointF</a>; otherwise returns a null
<a href="qpointf.html">QPointF</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toPyObject" />object QVariant.toPyObject (<i>self</i>)</h3><h3 class="fn"><a name="toReal" />(float, bool&#160;<i>ok</i>) QVariant.toReal (<i>self</i>)</h3><p>Returns the variant as a qreal if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Double</a>, <a href="qmetatype.html#Type-enum">QMetaType.Float</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.0.</p>
<p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if
the value could be converted to a double; otherwise
<tt>*</tt><i>ok</i> is set to false.</p>
<p>This function was introduced in Qt 4.6.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toRect" /><a href="qrect.html">QRect</a> QVariant.toRect (<i>self</i>)</h3><p>Returns the variant as a <a href="qrect.html">QRect</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Rect</a>; otherwise returns an invalid
<a href="qrect.html">QRect</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toRectF" /><a href="qrectf.html">QRectF</a> QVariant.toRectF (<i>self</i>)</h3><p>Returns the variant as a <a href="qrectf.html">QRectF</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Rect</a> or <a href="qvariant.html#Type-enum">RectF</a>; otherwise returns an invalid
<a href="qrectf.html">QRectF</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toRegExp" /><a href="qregexp.html">QRegExp</a> QVariant.toRegExp (<i>self</i>)</h3><p>Returns the variant as a <a href="qregexp.html">QRegExp</a> if
the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">RegExp</a>; otherwise returns an empty
<a href="qregexp.html">QRegExp</a>.</p>
<p>This function was introduced in Qt 4.1.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toSize" /><a href="qsize.html">QSize</a> QVariant.toSize (<i>self</i>)</h3><p>Returns the variant as a <a href="qsize.html">QSize</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Size</a>; otherwise returns an invalid
<a href="qsize.html">QSize</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toSizeF" /><a href="qsizef.html">QSizeF</a> QVariant.toSizeF (<i>self</i>)</h3><p>Returns the variant as a <a href="qsizef.html">QSizeF</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">SizeF</a>; otherwise returns an invalid
<a href="qsizef.html">QSizeF</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toString" />QString QVariant.toString (<i>self</i>)</h3><p>Returns the variant as a <a href="qstring.html">QString</a> if
the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">String</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Date</a>, <a href="qvariant.html#Type-enum">DateTime</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">StringList</a>, <a href="qvariant.html#Type-enum">Time</a>, <a href="qvariant.html#Type-enum">UInt</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns an empty
string.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toStringList" />QStringList QVariant.toStringList (<i>self</i>)</h3><p>Returns the variant as a <a href="qstringlist.html">QStringList</a> if the variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">StringList</a>, <a href="qvariant.html#Type-enum">String</a>, or <a href="qvariant.html#Type-enum">List</a> of a type that can be converted
to <a href="qstring.html">QString</a>; otherwise returns an empty
list.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toTime" /><a href="qtime.html">QTime</a> QVariant.toTime (<i>self</i>)</h3><p>Returns the variant as a <a href="qtime.html">QTime</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Time</a>, <a href="qvariant.html#Type-enum">DateTime</a>, or <a href="qvariant.html#Type-enum">String</a>; otherwise returns an invalid
time.</p>
<p>If the <a href="qvariant.html#type">type</a>() is <a href="qvariant.html#Type-enum">String</a>, an invalid time will be
returned if the string cannot be parsed as a <a href="qt.html#DateFormat-enum">Qt.ISODate</a> format time.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toUInt" />(int, bool&#160;<i>ok</i>) QVariant.toUInt (<i>self</i>)</h3><p>Returns the variant as an unsigned int if the variant has
<a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">UInt</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, or <a href="qvariant.html#Type-enum">ULongLong</a>; otherwise returns 0.</p>
<p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if
the value could be converted to an unsigned int; otherwise
<tt>*</tt><i>ok</i> is set to false.</p>
<p><b>Warning:</b> If the value is convertible to a <a href="qvariant.html#Type-enum">ULongLong</a> but is too large to be
represented in an unsigned int, the resulting arithmetic overflow
will not be reflected in <i>ok</i>. A simple workaround is to use
<a href="qstring.html#toUInt">QString.toUInt</a>(). Fixing this
bug has been postponed to Qt 5 in order to avoid breaking existing
code.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toULongLong" />(int, bool&#160;<i>ok</i>) QVariant.toULongLong (<i>self</i>)</h3><p>Returns the variant as as an unsigned long long int if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">ULongLong</a>, <a href="qvariant.html#Type-enum">Bool</a>, <a href="qvariant.html#Type-enum">ByteArray</a>, <a href="qvariant.html#Type-enum">Char</a>, <a href="qvariant.html#Type-enum">Double</a>, <a href="qvariant.html#Type-enum">Int</a>, <a href="qvariant.html#Type-enum">LongLong</a>, <a href="qvariant.html#Type-enum">String</a>, or <a href="qvariant.html#Type-enum">UInt</a>; otherwise returns 0.</p>
<p>If <i>ok</i> is non-null: <tt>*</tt><i>ok</i> is set to true if
the value could be converted to an int; otherwise
<tt>*</tt><i>ok</i> is set to false.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="toUrl" /><a href="qurl.html">QUrl</a> QVariant.toUrl (<i>self</i>)</h3><p>Returns the variant as a <a href="qurl.html">QUrl</a> if the
variant has <a href="qvariant.html#type">type</a>() <a href="qvariant.html#Type-enum">Url</a>; otherwise returns an invalid
<a href="qurl.html">QUrl</a>.</p>
<p><b>See also</b> <a href="qvariant.html#canConvert">canConvert</a>() and <a href="qvariant.html#convert">convert</a>().</p>


<h3 class="fn"><a name="type" /><a href="qtcore.html#Type-enum">Type</a> QVariant.type (<i>self</i>)</h3><p>Returns the storage type of the value stored in the variant.
Although this function is declared as returning <a href="qvariant.html#Type-enum">QVariant.Type</a>, the return value
should be interpreted as <a href="qmetatype.html#Type-enum">QMetaType.Type</a>. In particular,
<a href="qvariant.html#Type-enum">QVariant.UserType</a> is
returned here only if the value is equal or greater than <a href="qmetatype.html#Type-enum">QMetaType.User</a>.</p>
<p>Note that return values in the ranges <a href="qvariant.html#Type-enum">QVariant.Char</a> through <a href="qvariant.html#Type-enum">QVariant.RegExp</a> and <a href="qvariant.html#Type-enum">QVariant.Font</a> through <a href="qvariant.html#Type-enum">QVariant.Transform</a> correspond to the
values in the ranges <a href="qmetatype.html#Type-enum">QMetaType.QChar</a> through <a href="qmetatype.html#Type-enum">QMetaType.QRegExp</a> and <a href="qmetatype.html#Type-enum">QMetaType.QFont</a> through <a href="qmetatype.html#Type-enum">QMetaType.QQuaternion</a>.</p>
<p>Pay particular attention when working with char and <a href="qchar.html">QChar</a> variants. Note that there is no <a href="qvariant.html">QVariant</a> constructor specifically for type
char, but there is one for <a href="qchar.html">QChar</a>. For a
variant of type <a href="qchar.html">QChar</a>, this function
returns <a href="qvariant.html#Type-enum">QVariant.Char</a>, which
is the same as <a href="qmetatype.html#Type-enum">QMetaType.QChar</a>, but for a variant
of type <tt>char</tt>, this function returns <a href="qmetatype.html#Type-enum">QMetaType.Char</a>, which is <i>not</i>
the same as <a href="qvariant.html#Type-enum">QVariant.Char</a>.</p>
<p>Also note that the types <tt>void*</tt>, <tt>long</tt>,
<tt>short</tt>, <tt>unsigned</tt> <tt>long</tt>, <tt>unsigned</tt>
<tt>short</tt>, <tt>unsigned</tt> <tt>char</tt>, <tt>float</tt>,
<tt>QObject*</tt>, and <tt>QWidget*</tt> are represented in
<a href="qmetatype.html#Type-enum">QMetaType.Type</a> but not in
<a href="qvariant.html#Type-enum">QVariant.Type</a>, and they can
be returned by this function. However, they are considered to be
user defined types when tested against <a href="qvariant.html#Type-enum">QVariant.Type</a>.</p>
<p>To test whether an instance of <a href="qvariant.html">QVariant</a> contains a data type that is
compatible with the data type you are interested in, use <a href="qvariant.html#canConvert">canConvert</a>().</p>


<h3 class="fn"><a name="typeName" />str QVariant.typeName (<i>self</i>)</h3><p>Returns the name of the type stored in the variant. The returned
strings describe the C++ datatype used to store the data: for
example, "<a href="qfont.html">QFont</a>", "<a href="qstring.html">QString</a>", or "<a href="qvariant.html#QVariantList-typedef">QVariantList</a>". An Invalid
variant returns 0.</p>


<h3 class="fn"><a name="typeToName" />str QVariant.typeToName (<a href="qtcore.html#Type-enum">Type</a>&#160;<i>type</i>)</h3><p>Converts the enum representation of the storage type,
<i>typ</i>, to its string representation.</p>
<p>Returns a null pointer if the type is <a href="qvariant.html#Type-enum">QVariant.Invalid</a> or doesn't
exist.</p>


<h3 class="fn"><a name="userType" />int QVariant.userType (<i>self</i>)</h3><p>Returns the storage type of the value stored in the variant. For
non-user types, this is the same as <a href="qvariant.html#type">type</a>().</p>
<p><b>See also</b> <a href="qvariant.html#type">type</a>().</p>


<h3 class="fn"><a name="__eq__" />bool QVariant.__eq__ (<i>self</i>, QVariant&#160;<i>v</i>)</h3><h3 class="fn"><a name="__ne__" />bool QVariant.__ne__ (<i>self</i>, QVariant&#160;<i>v</i>)</h3><address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt&#160;snapshot-4.9.5-9eb6aac99275 for X11</td><td align="center" width="50%">Copyright &#169; <a href="http://www.riverbankcomputing.com">Riverbank&#160;Computing&#160;Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2012</td><td align="right" width="25%">Qt&#160;4.8.3</td></tr></table></div></address></body></html>